【笔记】OpenClaw学习笔记

发表于 2026-03-11 更新于 2026-03-12 阅读次数：

前言

OpenClaw学习笔记

AI开放平台的API密钥

Kimi K2.5

获取API密钥

访问https://platform.moonshot.cn/console/api-key->登录->新建 API Key->复制 API Key

IM开放平台的API密钥

飞书

获取API密钥

访问https://open.feishu.cn/app->登录->创建企业自建应用

创建机器人

配置机器人信息->创建

凭证与基础信息->复制 App ID 和 App Secret

添加应用能力->添加机器人

发布机器人

版本管理与发布->创建版本

配置版本信息->保存

确认发布

为机器人授予权限

权限管理->开通权限->搜索im:->全选->确认开通权限

开通权限->搜索获取通讯录基本信息->勾选获取通讯录基本信息->确认开通权限

为机器人使用长连接接收事件

这个操作必须在初始化完飞书插件后（配置完飞书插件并启动网关后）执行，因为必须已经建立长连接后才能修改事件与回调配置
事件与回调->修改配置

勾选使用长连接接收事件->保存

添加事件->搜索接收消息->勾选接收消息->添加

重新发布机器人

添加机器人对话

搜索机器人名称，添加机器人对话

首次对话提示权限不足，需要根据提示的命令添加权限

1	openclaw pairing approve feishu XXXXXXXX

下载依赖

1	npm install -g openclaw

初始化

1	openclaw onboard

◇  Security

◇  I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue?
● Yes / ○ No

◇  Onboarding mode
● QuickStart (Configure details later via openclaw configure.)
○ Manual

Gateway port: 18789
Gateway bind: Loopback (127.0.0.1)
Gateway auth: Token (default)
Tailscale exposure: Off
Direct to chat channels.

◇  Model/auth provider
○ OpenAI
○ Anthropic
○ Chutes
○ vLLM
○ MiniMax
● Moonshot AI (Kimi K2.5) (Kimi K2.5 + Kimi Coding)
○ Google
○ xAI (Grok)
○ Mistral AI
○ Volcano Engine
○ BytePlus
○ OpenRouter
○ Kilo Gateway
○ Qwen
○ Z.AI
○ Qianfan
○ Copilot
○ Vercel AI Gateway
○ OpenCode Zen
○ Xiaomi
○ Synthetic
○ Together AI
○ Hugging Face
○ Venice AI
○ LiteLLM
○ Cloudflare AI Gateway
○ Custom Provider
○ Skip for now

◇  Moonshot AI (Kimi K2.5) auth method
○ Kimi API key (.ai)
● Kimi API key (.cn)
○ Kimi Code API key (subscription)
○ Back

◇  How do you want to provide this API key?
● Paste API key now (Stores the key directly in OpenClaw config)
○ Use external secret provider

◇  Enter Moonshot API key (.cn)

◇  Model configured
Default model set to moonshot/kimi-k2.5

◇  Default model
● Keep current (moonshot/kimi-k2.5)
○ Enter model manually
○ moonshot/kimi-k2.5

◇  Channel status
Telegram: needs token
WhatsApp (default): not linked
Discord: needs token
Slack: needs tokens
Signal: needs setup
signal-cli: missing (signal-cli)
iMessage: needs setup
imsg: missing (imsg)
IRC: not configured
Google Chat: not configured
LINE: not configured
Feishu: install plugin to enable
Google Chat: install plugin to enable
Nostr: install plugin to enable
Microsoft Teams: install plugin to enabl
Mattermost: install plugin to enable
Nextcloud Talk: install plugin to enable
Matrix: install plugin to enable
BlueBubbles: install plugin to enable
LINE: install plugin to enable
Zalo: install plugin to enable
Zalo Personal: install plugin to enable
Synology Chat: install plugin to enable
Tlon: install plugin to enable

◇  Select channel (QuickStart)
○ Telegram (Bot API)
○ WhatsApp (QR link)
○ Discord (Bot API)
○ IRC (Server + Nick)
○ Google Chat (Chat API)
○ Slack (Socket Mode)
○ Signal (signal-cli)
○ iMessage (imsg)
○ LINE (Messaging API)
● Feishu/Lark (飞书) (plugin · install)
○ Nostr (NIP-04 DMs)
○ Microsoft Teams (Bot Framework)
○ Mattermost (plugin)
○ Nextcloud Talk (self-hosted)
○ Matrix (plugin)
○ BlueBubbles (macOS app)
○ Zalo (Bot API)
○ Zalo (Personal Account)
○ Synology Chat (Webhook)
○ Tlon (Urbit)
○ Skip for now

◇  Install Feishu plugin?
● Download from npm (@openclaw/feishu)
○ Use local plugin path
○ Skip for now

◇  Feishu credentials

◇  How do you want to provide this App Secret?
● Enter App Secret (Stores the credential directly in OpenClaw config)
○ Use external secret provider

◇  Enter Feishu App Secret

◇  Enter Feishu App ID

◇  Feishu connection test
Connected as xx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

◇  Feishu connection mode
● WebSocket (default)
○ Webhook

◇  Which Feishu domain?
● Feishu (feishu.cn) - China
○ Lark (larksuite.com) - International

◇  Group chat policy
○ Allowlist - only respond in specific groups
● Open - respond in all groups (requires mention)
○ Disabled - don't respond in groups

◇  Search provider
○ Brave Search
○ Gemini (Google Search)
○ Grok (xAI)
● Kimi (Moonshot) (Moonshot web search)
○ Perplexity Search
○ Skip for now

◇  Kimi (Moonshot) API key

◇  Skills status
Eligible: 8
Missing requirements: 40
Unsupported on this OS: 7
Blocked by allowlist: 0

◇  Configure skills now? (recommended)
○ Yes / ● No

◇  Hooks
Hooks let you automate actions when agent commands are issued.
Example: Save session context to memory when you issue /new or /reset.
Learn more: https://docs.openclaw.ai/automation/hooks

◇  Enable hooks?
◼ Skip for now

网关

启动网关

1	openclaw gateway start

停止网关

1	openclaw gateway stop

重启网关

1	openclaw gateway restart

查看网关状态

1	openclaw gateway status

修改配置

1	openclaw config

修改网关配置

修改网关从Loopback改为LAN以允许网络访问

1	openclaw config

◇  Where will the Gateway run?
● Local (this machine) (Gateway reachable (ws://127.0.0.1:18789))

◇  Select sections to configure
○ Workspace
○ Model
○ Web tools
● Gateway (Port, bind, auth, tailscale)
○ Daemon
○ Channels
○ Skills
○ Health check
○ Continue

◇  Gateway port
18789

◇  Gateway bind mode
○ Loopback (Local only)
○ Tailnet (Tailscale IP)
○ Auto (Loopback → LAN)
● LAN (All interfaces) (Bind to 0.0.0.0 - accessible from anywhere on your network)
○ Custom IP

◇  Gateway auth
● Token (Recommended default)
○ Password
○ Trusted Proxy

◇  Tailscale exposure
● Off (No Tailscale exposure)
○ Serve
○ Funnel

◇  Gateway token source
● Generate/store plaintext token (Default)
○ Use SecretRef

◇  Gateway token (blank to generate)
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

◇  Select sections to configure
○ Workspace
○ Model
○ Web tools
○ Gateway
○ Daemon
○ Channels
○ Skills
○ Health check
● Continue (Done)